home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Chip 1996 September
/
CHIP 1996 szeptember (CD07).zip
/
CHIP_CD07.ISO
/
sac
/
pack
/
sarj121.exe
/
arj
/
SARJ.DOC
< prev
Wrap
Text File
|
1996-01-07
|
23KB
|
595 lines
▓▓▓▓▓▓▓▓▓░ ▓▓▓▓▓▓▓▓▓░ ▓▓▓▓▓▓▓▓░ ▓▓░
▓▓░ ▓▓░ ▓▓░ ▓▓░ ▓▓░ ▓▓░
▓▓▓▓▓▓▓▓▓░ ▓▓▓▓▓▓▓▓▓░ ▓▓▓▓▓▓▓▓░ ▓▓░
▓▓░ ▓▓░ ▓▓░ ▓▓ ▓▓░ ▓▓░ ▓▓░
▓▓░ ▓▓░ ▓▓░ ▓▓░ ▓▓ ▓▓░ ▓▓▓▓▓▓▓▓░
▓▓▓▓▓▓▓▓▓░olid archives with the famous ARJ.
SARJ software and manual copyright (c) 1995-96 by Frederic Taes.
All rights reserved.
Main features
=============
- create and expand solid archives with the well-known ARJ;
- able to handle fool archives as it was an ARJ archive (GUS);
- support of Win95's long file names;
- ANSI archive comment allowed, with a fast display;
- ANSI.SYS *not* necessary;
- protection against ANSI-BOMB;
- optimized for a minimal use of the RAM (memory);
- compatibility with ARJ;
- security improved for encrypted arjives;
- often beter than C**** (a similar product);
- FreeWare program;
- ...
>> If you find SARJ useful, it is because ARJ is useful,
>> so please register ARJ ! This is mandatory for a use of SARJ
>> in a commercial, institutional, commercial, business or
>> government environment. Thanks... (See legal stuff below).
History
=======
v 1.01 : + also handle normal ARJ archives.
v 1.02 : + handle attributes (hidden, read-only, system, archive);
+ added SARJ.BTM compatibility (first 4DOS version).
v 1.03 : + possibility to specify a target path for extraction;
+ added compatibility for foreign countries
(date format DD/MM/YY or MM-DD-YY and time format 2x12h or 24h).
v 1.10 : + better compression ratio : make arjives usually 2% (up to 10%)
smaller than SARJ 1.0x;
+ automatic detection of the archive's format and then call the
appropriate program (ARJ, LIMIT, LZH, SQZ, UC2, ZIP, ZOO,...);
+ configuration of external archivers in SARJ.CFG.
v 1.11 : + better General Unpack Shell support
+ added the 'i' command to identify an archive
+ wilcards allowed as archive names (for extaction/list/...)
+ conversion batch file (from *.* to Solid-ARJ)
* changes the name of the '&' command for '£'
v 1.12 : + completely new CONVERT utility !
* renamed SARJ.EXE to S.EXE
+ added a default command : eXtract
+ search automatically external programs (pkunzip, unrar.exe,
lha.exe,...) in the whole path;
* change extension of solid archives to .SRJ
v 1.20 : + uncomplete and BETA release,
with support of Win95's long filenames
v 1.21 : + bugfix / final release of SARJ 1.20
+ improved compatibility between DOS mode and WIN95 mode
+ support of Win95's long filenames
NEXT RELEASE will include a new graphical interface !
Installation
============
Nothing to do. :-)
Notes :
- put all files somewhere in a directory of the PATH;
- S.EXE and SARJ.CFG should be in the same directory
- if a decompactor isn't in the path, you can specify the full path in
SARJ.CFG
- To use a cache memory software = much higher speed !
(SmartDrv, HyperDisk... not necessary with OS/2, WinNT or Win95)
Usage
=====
The syntax is the same as ARJ ! Except for the command "i" (see below).
You just have to replace "ARJ" by "S" (or "SARJ").
Usage: S <command> [-<sw> [-<sw>...]] <archive_name> [<file_names>...]
Examples: S a archive, S e archive, S l archive *.doc
<Commands>
: (nothing) eXtract (same as X) l: List contents of archive
a: Add files to a new archive m: Move files to a new archive
c: Comment archive (ANSI allowed) r: Remove paths from filenames
e: Extract files from archive t: Test integrity of archive
i: Identify type of archive x: eXtract files with full pathname
<Switches>
£: £eave all memory free for ARJ(R) p: match using full Pathnames
a: allow any file Attribute r: Recurse subdirectories
e: Exclude paths from names v: enable multiple Volumes (see ARJ!)
ja1: inhibit the display of comments w: assign Work directory (ex: -wC:\)
jp: Pause after each screenful x: eXclude selected files (ex: -x*.bk)
jt: Test CRC during compression y: assume Yes on all queries
g: Garble with password (-g? -gToto) z: comment archive (ex: -zARC.ANS)
See ARJ for more information about those switches (they are the same!).
So, with SARJ you can use the same syntax to expand all kind of archives:
ARJ, Solid-ARJ, LZH, ZIP, etc.
Create and expand solid archives with the well-known ARJ
========================================================
The principal behind SARJ is not new : it takes advantage of the fact that
big files will generally compress better than small files, a property used
by Unix users who follow the maxim "always tar before compress" (joining
files together before compressing). SARJ will automatically do this for
you, generating a single file SARJ.SLD, with the directory in a separate
file (SARJ.DIR). Those two files are compressed with ARJ.
Known problems with this method :
- updates (if any) are slow;
- if there's a problem within an archive (ex: a CRC error on your disk),
you loose the whole archive.
Advantages:
- compression ratio are better : usually 10%, but some files to compress
are similar or of the same type (ex: 100 little text files), up to 50%
improvement (or even more!).
An example
==========
I've take some files distributed with the well-known messages editor "GoldED"
(Author: Odinn Sorensen). I've compared the original archives .ZIP (PKZIP
2.04g, in maximal compression -eX; Author: Phil Katz & C°) with ARJ 2.41a
alone and SARJ. Here are the results (in bytes) :
.ZIP .ARJ .SRJ (with SARJ 1.1)
ADVANCED 31163 30904 28673
CHARSETS 32550 31664 10197
COLORS 15171 13963 5082
COLORSET 14505 13345 4845
SIMPLE 12625 12599 12228
XLAT 56363 54767 13111
---------------------------------------------------------
TOTAL = 162,377 157,242 74,136 bytes
On Disk = 169,984 163,840 79,872 bytes
(because of cluster allocation)
Handle fool archives as it was an ARJ archive
=============================================
SARJ v1.1 is able to recognize -by default- if an archive has one of the
following formats : ARJ and SARJ (of course), but also AIN, LIMIT, LZH, RAR,
SQZ, UC2, ZIP and ZOO (from Rahul Dhesi).
<Commands available>
e: Extract files from archive t: Test integrity of archive
l: List contents of archive x: eXtract files with full pathname
Examples :
----------
S TOTO.ZIP -> SARJ expand the file TOTO.ZIP in the current
directory
S e PCMAN.ZIP C:\TEMP -> SARJ's launching PKUNZIP to decompress
PCMAN.ZIP in the directory C:\TEMP
S t B2A054FE1.MO1 -> SARJ detects which one is the appropriate
decompactors between LZH, ZIP,... and
launch it to test the data-integrity (CRC)
of the archive B2A054FE1.MO1
SARJ does NOT recognize an archive format by its extension, but by its
internal signature. So, you can rename PCMAN.LZH to PCMAN.ZIP, and SARJ
will detect that PCMAN.ZIP is in fact a LZH archive.
It is possible that you have to modify SARJ.CFG a little bit. For example,
by renaming unrar.exe (freeware version) in rar.exe, or pkunzip.exe in
unzip.exe, etc.
An errorlevel 9 is returned when SARJ cannot detect the archive's format.
Support of Win95's long file names
==================================
Win95 allow you to use file names of more than 8+3 characters.
SARJ recognizes automatically (!) if you're running a DOS session under
Win95 or not.
Under Win95, SARJ displays :
SARJ v1.21 (Win95 mode) - FreeWare (C)opyRight 1996, TSF SoftWare.
= You're able to store and restore Win95's long filenames
With MS-DOS v2.11-6.2x, DR/Novell-DOS,... SARJ displays :
SARJ v1.21 (DOS mode) - FreeWare (C)opyRight 1996, TSF SoftWare.
= You're not able to handle Win95's long filenames
= If necessary, SARJ will automatically cut and rename files
during extraction. For instance, files "JacquesBrel-1.MID"
and "JacquesBrel-2.MID" will be decompressed as "JACQU~1.MID"
and "JACQU~2.MID". If files already exists, you'll be prompted
for erase, skip or rename them.
Limitations :
- Long file names of archives are not supported;
it's due to a limitation of ARJ 2.4x, PKZIP 2.04g, etc.;
- Long filenames of directories are not supported;
it's due to a limitation of Win95 : a bug occurs in DOS
sessions when pathnames are too long. Explanation : a
command line, and/or parameters passed to a program cannot
exceed 255 characters long. The problem is that a single
directory may have 259 characters long, and so a whole
pathname can be much greater than 255 characters long.
ANSI archive comment allowed
============================
SARJ is useful on a BBS because :
- arjives are -usually- not updated;
- arjives are smaller;
- ANSI comments are displayed;
And...
- with a fast display of ANSI comments;
- there's a protection against any "ANSI bomb", so don't panic;
- an ANSI.SYS driver is NOT required to see ANSI-comments;
- but the size of the archive comment is limited to 2 Ko.
Optimized for a minimal use of the RAM (memory)
===============================================
SARJ uses a few memory, and works with dynamic variables : it allocates
memory only when necessary. It releases a maximum of memory before
calling ARJ.
If there's ARJR.EXE somewhere in the path, Sarj uses ARJR.EXE instead of
ARJ.EXE. Note that ARJR.EXE takes less memory than ARJ.EXE.
Anyway, if it's not enough, there's a mode "leave all memory free for
ARJ(R)", useful for small "DOS sessions" (under DV, for instance), or
for a shell DOS with a few memory. If you use SARJ in a batch file,
it can be necessary to add "CALL SARJTMP" in your batch file, on the
line immediately after S.EXE.
-> A cache program like "smartdrv" or "hyperdisk" is recommanded for a
good speed improvement !
Compatibility with ARJ
======================
The first version of SARJ was SARJ.BTM, and used for a personal use.
To compress files, the following .BTM file (4DOS) is working !
(SARJ not required) :
REM Temp. directory required; ex.: MD C:\TEMP
DEL C:\TEMP /Y
DIR *.* /HTKM > C:\TEMP\SARJ.DIR
COPY /B *.*+C:\TEMP\SARJ.SLD C:\TEMP\SARJ.SLD
ARJ m ARCHIVE C:\TEMP\SARJ.* -jm -e
So, a SARJ archive is -almost- a normal arjive.
For instance, to see the contents of an archive, try :
ARJ s archive SARJ.DIR to see the directory
ARJ s archive SARJ.SLD to see the files
ARJ t archive SARJ.DIR SARJ.SLD to test integrity of archive
ARJ c archive -zARJ.CMT to comment archive (header only)
More security for encrypted arjives
===================================
If you're using " ARJ a secret *.DOC -gKate ", you can see after that
anybody can see the directory (not the files!) of the encrypted archive.
With SARJ, it is not a problem since the directory is also encrypted !
Less security for data recovery
===============================
There're some switches, as the serie "-v" (multi-volumes), not mentionned
by SARJ but that can be used. But be carreful with multi-volumes solid
archives : if you lost the first volume, you lost all volumes (the whole
archive) ! So don't use SARJ nor any 'solid' archiver to make a big backup.
SARJ is FreeWare
================
- This software is provided "as is", without any warranty;
- You can copy SARJ for yourself or use this program as you want to;
- any modification of the software is strictly forbidden;
- you can copy and distribute the "full package SARJ" to your friends;
- the full package contains not only S.EXE but also documentation
files,... and is provided within an ARJ-SECURED envelope with the
signature "TSF SoftWare / Prisme";
- This is a free product, so it can be distribute only "free of charge".
How to use SARJ ?
=================
Some examples :
Add files of current directory in a new archive: SARJ a archive
idem + subdirectories: SARJ a archive -r
idem + subdir. and "take less memory" mode: SARJ a archive -r -&
Add files with ARJ.ANS as comment: SARJ a archive -zARJ.ANS
Comment archive witch ARJ.ANS: SARJ c archive ARJ.ANS
idem: SARJ c archive -zARJ.ANS
Remove archive comment: SARJ c archive -zNUL
Move files to a new archive: SARJ m archive *.doc
Other examples (for files .ARJ .ZIP, .LZH,...):
Extract files from archive: SARJ e archive
idem but to TEMP\ (subdirectory): SARJ e archive TEMP\
idem but for ALL archives: SARJ e *.* TEMP\
Extract the file READ.ME from archive: SARJ e archive READ.ME
Extract maintaining directory structure: SARJ archive
idem (for compatibility with ARJ) SARJ x archive
idem but to F:\MODEM: SARJ x archive F:\MODEM
idem but for all *.ZIP files SARJ x *.ZIP F:\MODEM
Test integrity of files in archive: SARJ t archive
Identify an archive SARJ i belgium.J01
(if archive not found: DOS Errorlevel=2)
>>>> NOTE: with SARJ 1.12, you can type "S" only instead of "SARJ" <<<<
Wilcards are accepted and fully implemented (at the opposite of ms-dos).
Examples:
ARJ a \pub\archive \*arj*.* \prisme\*e.doc -r
ARJ x \pub\*15*.*
-> All switches must be preceded by "-" or "/".
Pathnames
=========
By default, SARJ saves pathnames (but not the whole path) in a intelligent
way : if you have about 500 files in a directory, the path is saved one
time for the 500 files. Related commands and switches :
<Command>
r: Remove paths/attr. from filenames ARJ r archive
x: eXtract files with full pathname ARJ x archive f:\games
Target sub-directories are always automatically created during extraction.
<Switches>
e: Exclude paths from names ARJ a archive *.doc -e
p: match using full Pathnames ARJ a archive f:\*.ans -r -p
Other switches :
================
-a By default, SARJ only handle "normal" files, and ignores files
with an attribute like "Hidden", "Read-Only" or "System". With
the parameter -a, SARJ handle all of those files, and restore
their attributes during extraction.
-ja1 Do not display (ANSI) comment.
-jp Pause after each screen; may be useful with the "list" function.
Ex: SARJ l TEST -jp
-jt test archive during compression ! When you make a "move" of some
files to an archive on floppy-disks, is there's a CRC-error on the
disk, you lost all files. Except if you use ARJ, and its useful
switch -jt. -jt is now also available within SARJ.
-v Same result as with ARJ. See the documentation of ARJ for more
information. But be carreful with multi-volumes solid archives :
if you lost the first volume, you lost all volumes (the whole
archive) ! So don't use SARJ nor any 'solid' archiver to make a
big backup.
-w With the switch "-w" (w: assign Work directory), you can specify
to SARJ which directory can be use for the temporary files SARJ.SLD
and SARJ.DIR. It can be a different working directory than this one
of ARJ !
-x With the switch "-x" (x: eXclude selected files), you may exclude
some files, when archiving and restoring. Some examples...
Archive all files *.BBS except msgbase.bbs :
ARJ a archive *.bbs -xMSGBASE.BBS
Extracting all files except *.doc, *.txt and *4.* :
ARJ x archive -x*.doc -x*.txt -x*4.*
i = identify an archive
=======================
Here's the list of DOS ERRORLEVEL returned by SARJ i :
0 = ??? or unkown format
1 = SARJ format
2 = archive not found
10= ARJ
10+ = type of the archive (see SARJ.CFG)
By default : AIN = 11
LZH = 12
RAR = 13
ZOO = 14
LIMIT=15
SQZ = 16
UC2 = 17
ZIP = 18
Examples :
SARJ i belgium.J01 ; returns DOS ERRORLEVE 10
if belgium.j01 is an ARJ archive
S i TOTO.ZIP ; in a BATCH file
IF ERRORLEVEL==18 GOTO ZIP ; be careful because IF ERRORLEVEL==17
IF ERRORLEVEL==17 GOTO UC2 ; means if ERRORLEVEL is equal
... ; OR GREATER than 17 !!!
Legal Stuff
===========
This software is copyrighted (C) 1995-96 and written by Frederic
Taes, hereafter called the Author and Owner. All Rights Reserved.
The No-Nonsense Licence Statement
---------------------------------
This software and everything enclosed with it are protected by both
Belgian copyright law and international treaty provisions.
It is called "freeware".
FREEWARE software may be used, copied and distributed freely for
NONCOMMERCIAL use only IF:
▀▀▀▀▀▀▀▀▀▀▀▀▀
NO FEE IS CHARGED FOR USE, COPYING OR DISTRIBUTION.
IT IS NOT MODIFIED IN ANY WAY.
It may be distributed ONLY in it's original, unmodified compressed
package file. ~~~~~~~~~~
This means you may not add comments to the compressed package file
(also known as an archive file or simply an archive), nor may you
delete files from or add files to the archive file, UNLESS YOU HAVE
A WRITTEN PERMISSION TO DO SO.
Converting the archive file to another compression method or
another archive file format is allowed, provided that the above
conditions are met.
The original package as released by me is in R. Jung's ARJ archive
format, protected by a SECURITY-ENVELOPE (signature : TSF SoftWare
Prisme). In order to extract the files from an ARJ archive under
DOS, you will need to get the file ARJ***.EXE, where '***' stands
for the version number of the program ARJ. At the time this is
written, the latest version is 2.50a, so look for ARJ250A.EXE
(or ARJ250F.EXE for the French release).
Note, that recompressing the archive will nearly always result
in a bigger archive.
The use of FREEWARE software is prohibited in a governmental
or commercial situation. In these cases, this software must be
purchased and a Commercial Licence Statement will then be provided
for. You may write to the Owner at the address below for more
information.
Warranty
--------
This software is provided AS IS without any warranty, expressed or
implied, including but not limited to fitness for a particular
purpose.
IN NO EVENT SHALL THE AUTHOR/OWNER OF THIS PRODUCT BE LIABLE FOR
ANY DIRECT OR CONSEQUENTIAL LOSS OR DAMAGES WHICH MAY HAVE ARISEN
FROM THE USE OF THIS PRODUCT.
If your local law does not permit any of the statements made above,
or if you do not agree with any of them yourself, THEN YOU ARE NOT
LICENCED TO USE THIS PROGRAM!
Payment
-------
If you would like to use this product in a commercial or
governmental situation, you have to use SARJ ONLY WITH A REGISTERED
VERSION OF ARJ !
Final Comments
==============
Author : Frederic Taes
Authorized ARJ Agent (French speaking countries)
Date : January, 7th 1996
Version : 1.21 (une version en francais est disponible !)
Language: written in Borland Pascal 7.0 (the best language for PC (DOS))
Plan : SARJ/2, a version for OS/2 (when ARJ/2 available)
A more securated algorithm for encryption.
RARJ, an interface for ARJ and SARJ.
Use with: at least ARJ v2.4x, or better ARJ 2.50a
Thanks : to Robert K. Jung, author of ARJ
ARJ is copyrighted by ARJ Software, Robert and Susan Jung
P.O. Box 249, Norwood MA 02062, USA
Testers : Jean-Yves Simon, Jean-Michel Dossogne and Pascal Vandersteegen.
Dedication: This program is dedicated to Catherine Lefevre.
How to contact the author of SARJ :
===================================
TSF SoftWare
Frederic Taes
Rue du Noyer, 285
B-1040 Brussels
BELGIUM
Prisme BBS +32-2-736.60.29 (Sysop: Cedric Janssens)
from V22 (1200bps) to V34 (28k8), 8N1, FAX included.
Also on Programmer's Paradise (2:293/2009): +32-10-81.30.88
Fidonet : 2:291/752.7
internet: fta@info.fundp.ac.be
WWW : http://www.info.fundp.ac.be/~fta
Electronic conferences:
- in the Fidonet's echomail " ARJ "
- often in the internet newsgroup " comp.compression "
- ...
NEW Support BBS in Belgium for TSF SoftWare :
=============================================
Edge Of Delight BBS
Fidonet: 2:291/735 (SysOp: Pascal Vandersteegen)
Node #1: +32-2-375.56.51 Boca 28.8K (V34/VFAST)
Node #2: +32-2-375.89.23 ZyXel 19.2K
Node #3: +32-2-372.10.89 ISDN 64K
File Area : J1 (Distsites Zone) and then 007 TSF SoftWare
* To leave a message to me, it's very easy ! You just have to
* choose the command 'C' in the main menu of Edge Of Delight BBS.
-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: 2.6.2
mQBhAy462AgAAAECmgPJWqIn12qszt+xLj3Fzryufz9m1toZFyI6n2FRbPqzWnaB
sdDF+0jqfq3EWmREb2ym3NGDdGUA00vub0QrZdbXHCzPMzRHd8GAIjAwYBWoiPNx
rQAFEbQpRnJlZGVyaWMgVGFlcyA8MjoyOTEvNzUyLjAwN0BGaWRvTmV0Lm9yZz60
JEZyZWRlcmljIFRhZXMgPGZ0YUBpbmZvLmZ1bmRwLmFjLmJlPg==
=tdAi
-----END PGP PUBLIC KEY BLOCK-----
end of document